home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XmbDrawText.z / XmbDrawText
Encoding:
Text File  |  2002-10-03  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmbbbbDDDDrrrraaaawwwwTTTTeeeexxxxtttt((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXmmmmbbbbDDDDrrrraaaawwwwTTTTeeeexxxxtttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XmbDrawText, XwcDrawText - draw text using multiple font
  10.           sets
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           void XmbDrawText(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _i_t_e_m_s, _n_i_t_e_m_s)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Drawable _d;
  16.                 GC _g_c;
  17.                 int _x, _y;
  18.                 XmbTextItem *_i_t_e_m_s;
  19.                 int _n_i_t_e_m_s;
  20.  
  21.           void XwcDrawText(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _i_t_e_m_s, _n_i_t_e_m_s)
  22.                 Display *_d_i_s_p_l_a_y;
  23.                 Drawable _d;
  24.                 GC _g_c;
  25.                 int _x, _y;
  26.                 XwcTextItem *_i_t_e_m_s;
  27.                 int _n_i_t_e_m_s;
  28.  
  29.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.           _d         Specifies the drawable.
  31.  
  32.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  33.  
  34.           _g_c        Specifies the GC.
  35.  
  36.           _i_t_e_m_s     Specifies an array of text items.
  37.  
  38.           _n_i_t_e_m_s    Specifies the number of text items in the array.
  39.  
  40.           _x
  41.           _y         Specify the x and y coordinates.
  42.  
  43.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  44.           The _X_m_b_D_r_a_w_T_e_x_t and _X_w_c_D_r_a_w_T_e_x_t functions allow complex
  45.           spacing and font set shifts between text strings.  Each text
  46.           item is processed in turn, with the origin of a text element
  47.           advanced in the primary draw direction by the escapement of
  48.           the previous text item.  A text item delta specifies an
  49.           additional escapement of the text item drawing origin in the
  50.           primary draw direction.  A font_set member other than _N_o_n_e
  51.           in an item causes the font set to be used for this and
  52.           subsequent text items in the text_items list.  Leading text
  53.           items with a font_set member set to _N_o_n_e will not be drawn.
  54.  
  55.           _X_m_b_D_r_a_w_T_e_x_t and _X_w_c_D_r_a_w_T_e_x_t do not perform any context-
  56.           dependent rendering between text segments.  Clients may
  57.           compute the drawing metrics by passing each text segment to
  58.           _X_m_b_T_e_x_t_E_x_t_e_n_t_s and _X_w_c_T_e_x_t_E_x_t_e_n_t_s or _X_m_b_T_e_x_t_P_e_r_C_h_a_r_E_x_t_e_n_t_s
  59.           and _X_w_c_T_e_x_t_P_e_r_C_h_a_r_E_x_t_e_n_t_s.  When the _X_F_o_n_t_S_e_t has missing
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmbbbbDDDDrrrraaaawwwwTTTTeeeexxxxtttt((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXmmmmbbbbDDDDrrrraaaawwwwTTTTeeeexxxxtttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           charsets, each unavailable character is drawn with the
  75.           default string returned by _X_C_r_e_a_t_e_F_o_n_t_S_e_t.  The behavior for
  76.           an invalid codepoint is undefined.
  77.  
  78.      SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEESSSS
  79.           The _X_m_b_T_e_x_t_I_t_e_m structure contains:
  80.           typedef struct {
  81.                char *chars;        /* pointer to string */
  82.                int nchars;         /* number of bytes */
  83.                int delta;          /* pixel delta between strings */
  84.                XFontSet font_set;  /* fonts, None means don't change */
  85.           } XmbTextItem;
  86.      The _X_w_c_T_e_x_t_I_t_e_m structure contains:
  87.      typedef struct {
  88.           wchar_t *chars;     /* pointer to wide char string */
  89.           int nchars;         /* number of wide characters */
  90.           int delta;          /* pixel delta between strings */
  91.           XFontSet font_set;  /* fonts, None means don't change */
  92.      } XwcTextItem;
  93.  
  94.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.           XDrawImageString(3X11), XDrawString(3X11), XDrawText(3X11),
  96.           XmbDrawImageString(3X11), XmbDrawString(3X11)
  97.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.